package com.xinke.module.system.service.user;

import java.util.*;
import javax.validation.*;
import com.xinke.module.system.model.vo.user.*;
import com.xinke.module.system.model.entity.user.RoleDO;
import com.xinke.component.common.pojo.PageResult;
import com.xinke.component.common.pojo.PageParam;

/**
 * 角色信息 Service 接口
 *
 * @author yzx
 */
public interface RoleService {
    /**
     * 创建角色
     *
     * @param createReqVO 创建角色信息
     * @param type 角色类型
     * @return 角色编号
     */
    Long createRole(@Valid RoleSaveReqVO createReqVO, Integer type);

    /**
     * 更新角色信息
     *
     * @param updateReqVO 更新信息
     */
    void updateRole(@Valid RoleSaveReqVO updateReqVO);

    /**
     * 删除角色信息
     *
     * @param roleId 编号
     */
    void deleteRole(Long roleId);

    /**
     * 获得角色信息
     *
     * @param roleId 编号
     * @return 角色信息
     */
    RoleDO getRole(Long roleId);

    /**
     * 获得角色信息分页
     *
     * @param pageReqVO 分页查询
     * @return 角色信息分页
     */
    PageResult<RoleDO> getRolePage(RolePageReqVO pageReqVO);
    /**
     * 获得角色列表
     *
     * @param roleIds 角色编号数组
     * @return 角色列表
     */
    List<RoleDO> getRoleList(Set<Long> roleIds);

    /**
     * 判断角色编号数组中，是否有管理员
     *
     * @param roleIds 角色编号数组
     * @return 是否有管理员
     */
    boolean hasAnySuperAdmin(Collection<Long> roleIds);

    /**
     * 获得角色，从缓存中
     *
     * @param id 角色编号
     * @return 角色
     */
    RoleDO getRoleFromCache(Long id);

    /**
     * 获得角色数组，从缓存中
     *
     * @param ids 角色编号数组
     * @return 角色数组
     */
    List<RoleDO> getRoleListFromCache(Collection<Long> ids);

    /**
     * 设置角色的数据权限
     *
     * @param id 角色编号
     * @param dataScope 数据范围
     * @param dataScopeDeptIds 部门编号数组
     */
    void updateRoleDataScope(Long id, Integer dataScope, Set<Long> dataScopeDeptIds);
}